home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr37 / chk4d100.zip / CHK4DES.DOC next >
Text File  |  1995-04-05  |  6KB  |  122 lines
  1.  
  2.  
  3.    CHK4DES v1.00                  CHK4DES.DOC                        04/05/95
  4.  
  5.  
  6.    NOTE:  Enter COPY CHK4DES.DOC PRN to print this file.  It is formatted to
  7.           print 2 pages with approximately 60 lines per page.
  8.  
  9.  
  10.    CAUTION:  CHK4DES performs a self-test for viruses and/or tampering on
  11.    startup to insure that you have an unaltered program.  You cannot use an
  12.    executable file compressor such as PKLITE on CHK4DES or it will fail its
  13.    self-check and overwrite itself.
  14.  
  15.  
  16.    SYSOPS!
  17.  
  18.    This utility will hopefully make managing your BBS a little less time
  19.    consuming.  It was written at the request of the same PCBoard sysop that
  20.    suggested the development of MERGEPRO/MERGESYS.  He uses a concept he
  21.    calls "shovelware", which translated means he gets files from satellite,
  22.    fidonet, internet, other BBS's, ... "shovels" them all into a directory to
  23.    extract their file descriptions, then "uploads" them to his BBS.  CHK4DES
  24.    helps automate this process (see PRODUCTS.DOC for related programs).  It
  25.    works on ASCII text file descriptions in either WildCat! (the first two
  26.    lines of the description start at the left margin and the description ends
  27.    with an empty line) or PCBoard DIR format (only the first line starts at
  28.    the left margin and continuing lines start with a "space" or contain the
  29.    "pipe").  Lines can have up to 80 characters (anything more is truncated).
  30.  
  31.    CHK4DES runs on a list of file descriptions generated by a DIZ extractor,
  32.    such as WGM-MAKE, which will search a directory full of zips and create a
  33.    PCBoard type description file with the information from the FILE_ID.DIZ's.
  34.    However, if WGM-MAKE doesn't find a DIZ, it writes "Description is unknown
  35.    at this time." (without the quotes) in place of where the description
  36.    would normally go.  CHK4DES goes through the generated list and removes
  37.    all of the "no description" names to another file, which can be dealt with
  38.    later.  The finished list will contain only file names with descriptions
  39.    that can then be added to your bbs file listings.  The default description
  40.    starting column is 34, which can be set to a different value if necessary.
  41.  
  42.    You can change the "no description" phrase to anything you want, including
  43.    an "empty" phrase, which will locate file names where the description area
  44.    is blank (nothing is there).  CHK4DES can also execute an optional batch
  45.    file with the name of each file that has a description, such as moving the
  46.    parent file to another directory.  To insure you aren't duplicating a file
  47.    already on-line, you could run MERGESYS in the compare mode on the list of
  48.    new descriptions against your existing file lists, which will remove any
  49.    duplicate descriptions from the new list.  WildCat! bbs's can still use
  50.    this technique, but with an extra step:  since the new descriptions are in
  51.    a text file, they would have to be converted to the database format before
  52.    inserting them into the existing file list database.
  53.  
  54.    Entering CHK4DES without any parameters accesses "help", which describes
  55.    the syntax and commands.  Since this utility is designed to run unattended
  56.    from a batch file, it quits with an errorlevel that can be tested.  For a
  57.    list of the various exit codes, please see the help system.  Its screen
  58.    output can also be redirected to create a log by using the "greater than"
  59.    symbol, e.g., CHK4DES newlist badlist > chk4des.log.  Using ">>" will
  60.    append a new log rather than overwriting the previous one.
  61.  
  62.  
  63.  
  64.                              DISCLAIMER OF WARRANTY
  65.  
  66.        THIS SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS", WITHOUT
  67.        WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT
  68.        NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
  69.        FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE
  70.        RESULTS AND PERFORMANCE OF THIS SOFTWARE IS ASSUMED BY THE USER.
  71.        IN NO EVENT WILL THE AUTHOR OF THIS SOFTWARE, OR ANYONE ELSE WHO
  72.        HAS BEEN INVOLVED IN ITS CREATION, PRODUCTION, OR DELIVERY, BE
  73.        LIABLE TO YOU OR ANY OTHER PARTY FOR ANY DIRECT, INDIRECT,
  74.        INCIDENTAL, OR CONSEQUENTIAL DAMAGES (INCLUDING DAMAGES FOR LOSS
  75.        OF BUSINESS PROFITS, INFORMATION, AND THE LIKE) RESULTING FROM ANY
  76.        DEFECT IN THIS SOFTWARE OR DOCUMENTATION OR ARISING FROM THE USE
  77.        OF OR INABILITY TO USE THIS SOFTWARE OR DOCUMENTATION EVEN IF THE
  78.        AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  79.  
  80.        BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO
  81.        WHICH THIS PROGRAM MAY BE PLACED, IT SHOULD ALWAYS BE THOROUGHLY
  82.        TESTED WITH NONCRITICAL DATA BEFORE RELYING ON IT.  YOUR USE OF
  83.        THIS SOFTWARE INDICATES THAT YOU HAVE READ AND AGREED TO THESE AND
  84.        ANY OTHER TERMS INCLUDED IN THIS SOFTWARE COLLECTION.  SOME STATES
  85.        DO NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES OR
  86.        LIABILITIES FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE
  87.        LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU.
  88.  
  89.  
  90.    Live long and prosper.
  91.  
  92.  
  93.    PCBoard is a registered trademark of Clark Development Company, Inc.
  94.    PKLITE is a registered trademark of PKWARE, Inc.
  95.    WildCat! is a trademark of Mustang Software, Inc.
  96.    WGM-MAKE is copyrighted by Wayne G. Maas.
  97.  
  98.  
  99.    You may contact me at any of the addresses given below.
  100.  
  101.    Write to:  Hal Parks                  E-Mail:  8:970/201           RBBSNet
  102.               HAL SoftWare                        1:11/157            FIDONet
  103.               404B W. Oak                                   InterNet
  104.               Carbondale, IL 62901                charlies@skelos.lib.siu.edu
  105.  
  106.    OR leave a message for me with InfoQuest BBS at 618-529-0000
  107.    OR through InfoQuest's sysop (safest bet for E-Mail and messages)
  108.  
  109.             InterNet:  charlies@skelos.lib.siu.edu
  110.             RBBSNet:   8:970/201       FIDONet:  1:11/157
  111.                             USERNAME:  Charles Strusz
  112.             FIDO NODELIST CORRECTION:  Phone should be 618.529.0000
  113.  
  114.  
  115.    The latest version can always be downloaded by calling:
  116.  
  117.    InfoQuest BBS, Carbondale, IL, 618-529-0000 (sign on as a GUEST USER and
  118.                                                    join the HAL conference)
  119.    Shawnee Free-Net BBS, Carbondale, IL, 618-549-8448
  120.    Rusty-n-Edie's BBS, Youngstown, OH, 216-726-2620
  121.  
  122.